Troubleshooting
___________________________________
Some frequently asked questions

This quick reference provides answers to some common problems that may occur when using Eclipse. If your question is not listed here, please contact us for further assistance (see the Registration and Contact Info chapter for more information).

Here is what has been changed in version 3.0.1.

     -- Fixed a bug in the gamma code that could cause the monitor's CLUT to be messed up after the screen was unfaded.

     -- Fixed a bug that would cause Eclipse to generate an error message if it received an Apple Event that it didn't handle.

     -- Eclipse no longer switches processes if it is set to just dim the screen, and no password is set.

     -- Eclipse will now keep itself the frontmost process if the password dialog is up, preventing easy circumvention when you have it set to "Just dim the screen."

     -- Added a "Don't ask again" button to the startup file creation dialog box.

     -- Updated the copyright, version, and other such information.

     -- Included the new Register Eclipse application, which has a bug fix, and the WWW registration information in it.

     -- Fixed a bug that would cause Eclipse to clip images improperly if you were using more than one monitor, with a secondary screen to the left or above of the main screen.

     -- Included the "Eclipse Admin" program for system administrators who need to set a master password for Eclipse, in addition to the user password

Eclipse doesn’t launch at start-up time. Why not?

When you run Eclipse, it checks in your Startup Items folder for its startup document. If it’s not there, Eclipse creates a new one. If Eclipse is not launching at startup, check to see if the “Eclipse Startup” file is in the Startup Items folder. If it’s not, simply run Eclipse manually (by double-clicking on the Eclipse icon). A new startup document will be created.

When Eclipse dims the screen, I do not see anything, even though I have the preferences set to display a graphic. The screen just goes black. What’s happening?

There are two separate controls that affect what appears on your screen, the Display Settings and the Dimming Settings. If the screen is being dimmed to total black, the graphic or clock will not be seen. To solve this, raise the dimming percentage above 0 percent.

Why doesn’t Eclipse display my QuickTime movies?

To have Eclipse display QuickTime movies, the QuickTime extension needs to be installed on your system. Without this extension, QuickTime movies and graphics in the JPEG format can’t be shown; Eclipse skips them.

Another reason Eclipse may skip movies is due to the fact that it isn't seen as a QuickTime movie. Some applications will write code to a QuickTime movie that actually plays the movie when it is opened. This changes the movie to an application. Eclipse will not recognize it and will skip over it. You can check this in the Get Info... window. The “Kind:” of file should be “QuickTime movie.”

Why doesn’t Eclipse display all of the graphics in the Eclipse Graphics folder?

Eclipse can display PICT, JPEG, GIF files and QuickTime movies. However, Eclipse needs the QuickTime extension installed to display any JPEG files or QuickTime movies. If a graphic is not displayed, it’s probably because the file is in the wrong format or the QuickTime extension is not installed.

Why does Eclipse skip over some of the aliases in my Eclipse Graphics folder?

Eclipse resolves aliases to files if the aliases are placed in the Eclipse Graphics folder. But, if the file is not in the right format or if the QuickTime extension is not installed (see above question), aliases to these files will be skipped. Eclipse will also skip over aliases whose files are no longer available.

I placed a folder in the Eclipse Graphics folder, but nothing in the new folder is displayed. Why not?

Eclipse sees a folder (or an alias to a folder) in the Eclipse Graphics folder as a file it cannot display and will skip over it. Place the files, or aliases, directly into the Eclipse Graphics folder.

Can I place an alias to the Eclipse Graphics folder in the Eclipse folder?

Yes, if you have a folder filled with graphics somewhere on your system, you can make an alias of that folder, move it to the Eclipse folder, and rename it “Eclipse Graphics.” Eclipse will display the files located in the aliased folder. Move the original Eclipse Graphics folder out of the Eclipse folder or rename it.

Why doesn’t Eclipse work with Now Menus™ running?

It does, but only if “Auto-hide Application Menus” is de-selected in your Now Menus preferences. Otherwise, Eclipse will only blink on for a second if it is not in the foreground. 

I have an application chosen in the Application Settings dialog box, but Eclipse still dims the screen when the application is running. Why?

Eclipse will only prevent itself from dimming the screen if the application is in the foreground. If the application is running, but is in the background, Eclipse still dims the screen.

At startup I receive an alert stating that the Eclipse Startup document can not be opened because the application that created it could not be found. Why?

This is caused by the system looking for the Eclipse application and not finding it. For the system to locate Eclipse, it needs to be somewhere on the start-up drive. Startup Items are opened before SCSI and networked volumes are mounted. If Eclipse is not on the startup volume, you will receive this message. You will also receive this message if Eclipse is removed from the system altogether and the Eclipse Startup document is still in the Startup folder.

This can also happen on a machine with only one drive. If this happens, try rebuilding the desktop by holding the command and options keys down during startup.

I was using Eclipse and received a message that stated: “Eclipse is critically low on memory.” I have plenty of RAM. What’s happening?

Chances are you are using an extension that allocates memory in Eclipse’s memory space (such as Speed Doubler™). There are two solutions: you can disable the extension, or raise Eclipse’s memory allocation by 10K and try running Eclipse again.

When I click on the Register... button, it says it can’t find the “Register Eclipse” application. Why?

Probably because it is no longer on your system, or has been moved out of the folder as the Eclipse application. If the Register Eclipse application has been moved, you need to move it back into the same folder as the Eclipse application. If you no longer have the Register Eclipse application, you will need to download a new copy of Eclipse or reinstall from a backup. The Register Eclipse application is used to register your copy of Eclipse and to enter your license code. You should not throw it out or move it in case you need to reenter your license code in the future.